icontheme: Clarify the docs

Mention that icons directly in /$app_id/icons/ are treated
as unthemed icons.

See #3216

diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index 848d2848fa879ffd34eb1f0779ba918cb2e3a42b..49d16d5ca52383067d200c0977ff6194300840bf 100644 (file)
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -1542,9 +1542,12 @@ gtk_icon_theme_add_search_path (GtkIconTheme *self,
  *
  * The resources are considered as part of the hicolor icon theme
  * and must be located in subdirectories that are defined in the
- * hicolor icon theme, such as `@path/16x16/actions/run.png`.
+ * hicolor icon theme, such as `@path/16x16/actions/run.png`
+ * or `@path/scalable/actions/run.svg`.
+ *
  * Icons that are directly placed in the resource path instead
- * of a subdirectory are also considered as ultimate fallback.
+ * of a subdirectory are also considered as ultimate fallback,
+ * but they are treated like unthemed icons.
  */
 void
 gtk_icon_theme_set_resource_path (GtkIconTheme       *self,